home *** CD-ROM | disk | FTP | other *** search
/ ShareWare OnLine 2 / ShareWare OnLine Volume 2 (CMS Software)(1993).iso / games2 / twast11.zip / TWASSIST.DOC next >
Text File  |  1993-02-06  |  92KB  |  2,340 lines
  1.  
  2.  
  3.                         ▄                             ▄
  4.          ▀▀█▀▀  █▀▀▄  █▀▀▀█  █▀▀▄  █▀▀▀  █▄     ▄█  █▀▀▀█  █▀▀▄  █▀▀▀
  5.            █    █▄▄▀  █▄▄▄█  █  █  █▀▀    █ ▄█▄ █   █▄▄▄█  █▄▄▀  ▀▀▀█
  6.            █    █  █ ▄█   █▄ █▄▄▀  █▄▄▄   █▄█ █▄█  ▄█   █▄ █  █  ▄▄▄█
  7.       ▄                                               ▄
  8.    ███████  ███████  ███████  ██  ███████  ██████  ███████  ██    ██  ██████
  9.    ██   ██  ██       ██       ██  ██         ██    ██   ██  ███▄  ██    ██
  10.    ███████  ███████  ███████  ██  ███████    ██    ███████  ██▀██▄██    ██
  11.    ██   ██       ██       ██  ██       ██    ██    ██   ██  ██  ▀███    ██
  12.   ███   ███ ███████  ███████  ██  ███████    ██   ███   ███ ██    ██    ██
  13.  
  14.  
  15.                                  Version 1.1
  16.  
  17.                           Trade Wars 2002 Assistant
  18.                                by Albin Gersich
  19.                    (C) Copyright 1992 - Sasquatch Software
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63. ╔════════════════════════════════════════════════════════════════════════════╗
  64. ║                             Table of Contents                              ║
  65. ╚════════════════════════════════════════════════════════════════════════════╝
  66.  
  67.  
  68.   1   Introduction  . . . . . . . . . . . . . . . . . . . . . . . . . . .   4
  69.  
  70.        1.1   Features . . . . . . . . . . . . . . . . . . . . . . . . . .   4
  71.        1.2   Disclaimer . . . . . . . . . . . . . . . . . . . . . . . . .   5
  72.        1.3   Acknowledgements . . . . . . . . . . . . . . . . . . . . . .   5
  73.        1.4   Trademarks . . . . . . . . . . . . . . . . . . . . . . . . .   5
  74.        1.5   Compatibility  . . . . . . . . . . . . . . . . . . . . . . .   6
  75.        1.6   Files  . . . . . . . . . . . . . . . . . . . . . . . . . . .   7
  76.        1.7   Support and Distribution . . . . . . . . . . . . . . . . . .   8
  77.        1.8   Licensing and Registration . . . . . . . . . . . . . . . . .   9
  78.  
  79.  
  80.   2    Getting Started  . . . . . . . . . . . . . . . . . . . . . . . . .  10
  81.  
  82.  
  83.   3   (M)odify database menu  . . . . . . . . . . . . . . . . . . . . . .  12
  84.  
  85.        3.1   (E)xtract data from a capture file . . . . . . . . . . . . .  12
  86.        3.2   (A)voids . . . . . . . . . . . . . . . . . . . . . . . . . .  14
  87.        3.3   (B)usted . . . . . . . . . . . . . . . . . . . . . . . . . .  14
  88.        3.4   (F)ighters . . . . . . . . . . . . . . . . . . . . . . . . .  15
  89.        3.5   (M)ines  . . . . . . . . . . . . . . . . . . . . . . . . . .  15
  90.        3.6   (P)orts  . . . . . . . . . . . . . . . . . . . . . . . . . .  15
  91.        3.7   (W)arps  . . . . . . . . . . . . . . . . . . . . . . . . . .  16
  92.        3.8   (N)otes  . . . . . . . . . . . . . . . . . . . . . . . . . .  16
  93.        3.9   (G)ame information . . . . . . . . . . . . . . . . . . . . .  16
  94.        3.10  (S)hip information . . . . . . . . . . . . . . . . . . . . .  18
  95.        3.11  Merge another (T)rader's database  . . . . . . . . . . . . .  18
  96.        3.12  Strip database for (O)ther trader  . . . . . . . . . . . . .  19
  97.  
  98.  
  99.   4   (D)atabase summary  . . . . . . . . . . . . . . . . . . . . . . . .  20
  100.  
  101.  
  102.   5   (N)otes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  21
  103.  
  104.        5.1   (V)iew notes . . . . . . . . . . . . . . . . . . . . . . . .  21
  105.        5.2   (E)dit notes . . . . . . . . . . . . . . . . . . . . . . . .  21
  106.        5.3   (S)earch notes   <Registered only> . . . . . . . . . . . . .  21
  107.  
  108.  
  109.   6   (P)ort Reports  . . . . . . . . . . . . . . . . . . . . . . . . . .  22
  110.  
  111.        6.1   (P)aired ports . . . . . . . . . . . . . . . . . . . . . . .  22
  112.        6.2   (N)earest ports  . . . . . . . . . . . . . . . . . . . . . .  23
  113.        6.3   (U)known status ports   <Registered only>  . . . . . . . . .  23
  114.        6.4   (B)usted ports . . . . . . . . . . . . . . . . . . . . . . .  23
  115.        6.5   (0) Closest place to buy class 0 items . . . . . . . . . . .  24
  116.  
  117.  
  118.  
  119.                                    Page 2
  120.  
  121.  
  122.                           Table of Contents (contd)
  123.  
  124.  
  125.   7   (S)ector Report . . . . . . . . . . . . . . . . . . . . . . . . . .  25
  126.  
  127.        7.1   (F)ull report on a sector  . . . . . . . . . . . . . . . . .  25
  128.        7.2   (N)earest sectors  . . . . . . . . . . . . . . . . . . . . .  26
  129.        7.3   (U)nexplored sectors . . . . . . . . . . . . . . . . . . . .  26
  130.        7.4   Une(x)plored clusters   <Registered only>  . . . . . . . . .  26
  131.        7.5   Un(k)nown sectors   <Registered only>  . . . . . . . . . . .  27
  132.        7.6   (W)ithout warps   <Registered only>  . . . . . . . . . . . .  27
  133.        7.7   (D)end end sector analysis . . . . . . . . . . . . . . . . .  28
  134.        7.8   (C)luster dead end analysis   <Registered only>  . . . . . .  28
  135.  
  136.  
  137.   8   (R)oute Reports . . . . . . . . . . . . . . . . . . . . . . . . . .  29
  138.  
  139.        8.1   (N)ormal route . . . . . . . . . . . . . . . . . . . . . . .  29
  140.        8.2   (T)ranswarp route  . . . . . . . . . . . . . . . . . . . . .  29
  141.        8.3   (S)pace lanes  . . . . . . . . . . . . . . . . . . . . . . .  30
  142.  
  143.  
  144.   9   (C)ustom Reports   <Registered only>  . . . . . . . . . . . . . . .  31
  145.  
  146.        9.1   (C)opy a report  . . . . . . . . . . . . . . . . . . . . . .  31
  147.        9.2   (D)isplay a report . . . . . . . . . . . . . . . . . . . . .  31
  148.        9.3   (E)xecute a report . . . . . . . . . . . . . . . . . . . . .  32
  149.        9.4   (M)odify a report  . . . . . . . . . . . . . . . . . . . . .  32
  150.        9.5   (R)ead reports from another file . . . . . . . . . . . . . .  32
  151.  
  152.  
  153.  10   (G)raphic Displays  . . . . . . . . . . . . . . . . . . . . . . . .  33
  154.  
  155.       10.1   Display around a (S)ector  . . . . . . . . . . . . . . . . .  33
  156.       10.2   Display along a (R)oute   <Registered only>  . . . . . . . .  33
  157.  
  158.  11   ($) Registration and configuration  . . . . . . . . . . . . . . . .  34
  159.  
  160.       11.1   Registration (N)ame  . . . . . . . . . . . . . . . . . . . .  34
  161.       11.2   Registration (C)ode  . . . . . . . . . . . . . . . . . . . .  34
  162.       11.3   (D)ESQview lines . . . . . . . . . . . . . . . . . . . . . .  34
  163.       11.4   (H)ot keys . . . . . . . . . . . . . . . . . . . . . . . . .  35
  164.       11.5   (S)creen writes  . . . . . . . . . . . . . . . . . . . . . .  35
  165.       11.6   (V)ideo driver . . . . . . . . . . . . . . . . . . . . . . .  35
  166.       11.7   (L)og file mode  . . . . . . . . . . . . . . . . . . . . . .  36
  167.  
  168.  
  169.  12   Multitasking Environments . . . . . . . . . . . . . . . . . . . . .  37
  170.  
  171.       12.1   DESQview . . . . . . . . . . . . . . . . . . . . . . . . . .  37
  172.  
  173.  
  174.  13   Future plans  . . . . . . . . . . . . . . . . . . . . . . . . . . .  39
  175.  
  176.  
  177.  
  178.  
  179.                                    Page 3
  180.  
  181.  
  182. ╔════════════════════════════════════════════════════════════════════════════╗
  183. ║ Section  1                    Introduction                                 ║
  184. ╚════════════════════════════════════════════════════════════════════════════╝
  185.  
  186.     Every good trader needs an assistant.  The assistant keeps records and
  187.   provides information so the trader can make better decisions.  Trade Wars
  188.   2002 (TW2002) is a bulletin board door game by Martech Software, Inc.  The
  189.   game has a lot of different aspects and keeping track of all the details by
  190.   hand can be quite tough.  I looked at utilities to help me with the game
  191.   but could not find one that met my needs or the needs of my friends, so I
  192.   decided to build one from scratch.  Trade Wars 2002 Assistant (TWASSIST)
  193.   was born.  After nine months of continuous work (with only a few sanity
  194.   breaks) version 1.0 was ready and released on October 12th, 1992.
  195.  
  196.     Hopefully you will find TWASSIST user friendly and intuitive to use.  This
  197.   document will explain how to get started and what each of the functions do.
  198.   Included in some areas are tips on how the information can be used to help
  199.   you play the game.
  200.  
  201.     As with all off-line utilities of this type, they can only tell you about
  202.   the universe as you know it.  Examples are routes and distances which can
  203.   only be plotted through sectors you have warp information for, as opposed to
  204.   the Federation Navigation System in the game that knows the entire universe
  205.   and can plot courses through any sector.  As a result, distances and routes
  206.   with the utility may be longer than those reported in the game.  They will
  207.   never be shorter.  The more of the universe you have information on, the
  208.   better the utility will match the game and the more information it can
  209.   provide in the various reports.
  210.  
  211.  
  212. ░▒▓█  1.1  █▓▒░  Features
  213.  
  214.     An intuitive menu structure is used to access various functions.
  215.  
  216.     The doc provides information on how to use a number of the reports in
  217.      the game.
  218.  
  219.     Create your own custom reports.
  220.  
  221.     Reports will use the entire screen if running in 43 or 50 line mode.
  222.  
  223.     Data is easily read from a capture file plus the capability to make
  224.      manual modifications.
  225.  
  226.     Easy to merge data from playing partners.  Your known data is
  227.      distinguished from merged data.
  228.  
  229.     Error and warning messages are in English, with any DOS message (if
  230.      applicable) added on.
  231.  
  232.     Backup data files are automatically provided.
  233.  
  234.     DESQview aware.  CPU time is given up while waiting for input.
  235.  
  236.     Supports hot keys.  User selectable.
  237.  
  238.  
  239.                                    Page 4
  240.  
  241.  
  242. ░▒▓█  1.2  █▓▒░  Disclaimer
  243.  
  244.     The TWASSIST package is provided AS IS.  Sasquatch Software makes no
  245.   warranty, either expressed or implied, with respect to the software or
  246.   documentation, including but not limited to their quality, performance,
  247.   merchantability, or fitness for a particular purpose. In no event will
  248.   Sasquatch Software or the author be liable for direct, indirect, special,
  249.   incidental, or consequential damages arising out of the use, misuse, or
  250.   inability to use the software or documentation, even if advised of the
  251.   possibility of such damages.
  252.  
  253.  
  254. ░▒▓█  1.3  █▓▒░  Acknowledgements
  255.  
  256.     I would like to give thanks to Gary and Mary Ann Martin of Martech
  257.   Software, Inc. for the excellent game, Trade Wars 2002.  It has provided
  258.   me with hours upon hours of entertainment and excitement.
  259.  
  260.     I would also like to acknowledge my beta testers, Dan Roseen and Casey
  261.   Stemp, for providing invaluable help with this program by discussing ideas
  262.   and working out the bugs.  They have also contributed the communications
  263.   program macros.  Thanks also go to Jason Jiggins for submitting a comm
  264.   program macro.
  265.  
  266.     Dan Roseen deserves special recognition.  He is a good friend and got me
  267.   interested in TW2002.  He convinced me of the need to develop TWASSIST and
  268.   inspired me to keep going when my morale was low.  He also offered his
  269.   bulletin board for a distribution point and setup a special message area
  270.   for TWASSIST support.
  271.  
  272.  
  273. ░▒▓█  1.4  █▓▒░  Trademarks
  274.  
  275.   DESQview is a trademark of Quarterdeck Office Systems.
  276.   IBM is a trademark of International Business Machines Corporation.
  277.   MS-DOS is a registered trademark of Microsoft Corporation.
  278.   QEMM-386 is a trademark of Quarterdeck Office Systems.
  279.   Windows is a trademark of Microsoft Corporation.
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.                                    Page 5
  300.  
  301.  
  302. ░▒▓█  1.5  █▓▒░  Compatibility
  303.  
  304.   Trade Wars 2002:
  305.  
  306.       This program has been tested for compatibility with TW2002 v1.03(d).
  307.       Compatibility with other versions or modified games is not guaranteed.
  308.  
  309.   Operating system:
  310.  
  311.       TWASSIST runs on an IBM or 100% compatible PC or AT running DOS.  It
  312.       has been tested under MS-DOS version 5.0.  Compatibility with other
  313.       versions or operating systems is not guaranteed.
  314.     
  315.       TWASSIST can be run in a window under DESQview.  It has been tested
  316.       under v2.26 on a 80286 PC and v2.42 on a 80386 PC.  It has also been
  317.       tested with QEMM-386 version 6.02.  For more information see the
  318.       section Multitasking Environments near the end of this document.
  319.  
  320.   RAM:
  321.  
  322.     TWASSIST allocates memory for some things as it is needed.  As a result
  323.     your memory requirements may be different than someone else's.  The
  324.     minimum memory required (no notes, no merging) is 300k bytes.  With some
  325.     notes and while merging another traders database about 360k bytes of RAM
  326.     will be required.  Large numbers of notes and the merging of another
  327.     database which also has a large number of notes can significantly increase
  328.     the amount of memory required, up to a maximum of 575k bytes.
  329.  
  330.   Disk:
  331.  
  332.       A hard disk is recommended, especially if you have multiple games.  It
  333.       is possible to run from a floppy based system.  Refer to the section on
  334.       files for information on file sizes.
  335.  
  336.   Video:
  337.  
  338.       The graphic displays require VGA 640x480 or EGA/VGA 640x350.  All other
  339.       parts of the program display standard text.  TWASSIST detects the number
  340.       of lines and will use all lines when displaying reports.  Testing has
  341.       been done using color monitors.  Compatibility with monochrome monitors
  342.       is unknown.
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.                                    Page 6
  360.  
  361.  
  362. ░▒▓█  1.6  █▓▒░  Files
  363.  
  364.   The TWASSIST version 1.1 package (TWAST11.ZIP) contains the following
  365.   files:
  366.  
  367.     TWASSIST.DOC     92208 02-06-93   1:10a     This document
  368.     TWASSIST.EXE    247356 02-06-93   1:10a     The executable program
  369.     TWASSIST.HIS      3894 02-06-93   1:10a     History information
  370.     TWASSIST.REG      4801 02-06-93   1:10a     Registration request form
  371.     TWASTMAC.DOC     17656 02-06-93   1:10a     Com. program macros document
  372.     TWASTMAC.ZIP      8951 02-06-93   1:10a     Com. program macros
  373.  
  374.   Files created by the program:
  375.  
  376.     TWASSIST.CFG    Configuration file.  This file is created in the same
  377.                     directory the program is located in.  Size is 256 bytes.
  378.  
  379.     TWASSIST.CFK    Backup of the configuration file.
  380.  
  381.     game.DAT        The database file of game information.  Each game will
  382.                     have a separate database file.  The 'game' part of the
  383.                     name is chosen by the user.  Minimum size is 40k, typical
  384.                     size is 50k, maximum size is 160k (lots of long notes).
  385.  
  386.     game.BAK        Backup of the database file.
  387.  
  388.     game.CUS        Custom reports file.  Size is 604 bytes.
  389.  
  390.     game.CUK        Backup of the custom reports file.
  391.  
  392.     game.LOG        A log file of the messages while extracting from a capture
  393.                     file or merging another traders database.  This is useful
  394.                     if you want to go back and check on some errors or other
  395.                     info.
  396.  
  397.     game.RPT        The default name used for the report file.  The actual
  398.                     name is chosen during runtime.  It can be anything,
  399.                     except for some reserved extensions shown in this list.
  400.                     More than one report file can be used by providing
  401.                     different names.  Sizes will vary.
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.                                    Page 7
  420.  
  421.  
  422. ░▒▓█  1.7  █▓▒░  Support and Distribution
  423.  
  424.     Updates and/or new releases of TWASSIST can be downloaded or file-
  425.   requested from Dan Roseen's BBS, The Night Owl, as shown below.  If you are
  426.   logging in, you will have to fill out a new user questionnaire.  Once you
  427.   have done this you will have enough access to download TWASSIST without
  428.   complete user verification.
  429.  
  430.     Dan has setup a special message area for supporting TWASSIST.  This
  431.   message area has a special menu (which looks like the TWASSIST menus) that
  432.   provides an easy way to download the latest version, check out the latest
  433.   news, and send messages to the author, Albin Gersich.  By using this menu
  434.   you will get the latest version without having to enter a file name as you
  435.   would from the files menu.  The sysop is not responsible for support of
  436.   TWASSIST, do not bother him with messages or chats.  Use the special
  437.   message area to send mail to the author.  This area has file attach
  438.   capability, allowing you to attach files of interest to your message.
  439.  
  440.     If you are experiencing problems, call The Night Owl BBS or write and
  441.   include the following information:
  442.  
  443.      ■ A detailed explanation of the problem.
  444.      ■ The game files:       game.DAT and, if you have one, game.CUS
  445.      ■ Configuration file:   TWASSIST.CFG (from the program directory)
  446.  
  447.   Mail can be sent to:
  448.  
  449.      Sasquatch Software
  450.      P.O. Box 4331
  451.      Kent, WA   98032
  452.  
  453.   Support and Distribution:
  454.   ─────────────────────────
  455.   Sysop:       Dan Roseen     (not the author)
  456.   BBS:         The Night Owl
  457.   Fidonet:     1:343/102
  458.  
  459.   Login:       (206)631-4949       24 Hrs.      Kent, WA - USA
  460.                1200/2400
  461.  
  462.   Mail/FREQ:   (206)631-1752  1:343/102         (this number is NOT for login)
  463.                USRobotics DS HST/V.32bis/V.42bis
  464.  
  465.   Comment:     For downloading latest version:  Download TWAST*.ZIP
  466.                           For file-requesting:  Use the magic name "TWASSIST"
  467.                                                 or request TWAST*.ZIP
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.                                    Page 8
  480.  
  481.  
  482. ░▒▓█  1.8  █▓▒░  Licensing and Registration
  483.  
  484.     The software and documentation is copyrighted and is protected by United
  485.   States copyright laws and international treaty provisions.  All rights
  486.   are reserved by Sasquatch Software.  The software is owned by Sasquatch
  487.   Software and title remains in Sasquatch Software.  You may distribute
  488.   unregistered versions of the program as long as the entire package (as
  489.   described in the section titled Files) is distributed together and no fee
  490.   is charged for the software (a nominal distribution or shipping fee is ok).
  491.   Distribution of registration codes, methods of defeating the registration
  492.   mechanism, or modified files is illegal.  You may not decompile,
  493.   disassemble, modify, merge, or reverse engineer the software in any way.
  494.                           
  495.     A registration fee is required to use all the features of TWASSIST.
  496.   There are a lot of unregistered features so you can get a feel for the
  497.   program before you decide to register.  If you purchase a registration code
  498.   you will be granted a license to use all the features of TWASSIST.  If you
  499.   decide not to register you are granted a license to continue to use the
  500.   unregistered features of TWASSIST.  The registered only menu items will
  501.   have the text "<Registered only>" on the right.  You will not be able to
  502.   select these menu items.  If the program is registered the registered only
  503.   text will be removed from the menu.
  504.  
  505.     Registration is a one time fee.  Once you register it will be good for
  506.   all future versions of this program.  One registration may be used by all
  507.   members of a household but it may be used on only one computer at a time.
  508.   If it is to be used by multiple people on multiple computers a registration
  509.   is required for each.  Registrations are not transferable.
  510.  
  511.     The registration price is US$15.  Sales tax for residents of Washington
  512.   state will be paid by Sasquatch Software.  For my good friends to the north,
  513.   I will accept C$18.  Prices are subject to change after April 1, 1993.
  514.  
  515.     Those who do not want to register, but wish to provide incentive for the
  516.   development of utilities, may contribute in any amount they desire. Records
  517.   will be kept of contributions should you decide to register at a later date.
  518.   Print out the registration order form, follow its instructions, and fill in
  519.   the blank for the amount of the contribution.
  520.  
  521.     Please send a check or money order in U.S. (or Canadian) funds.  If
  522.   payment is made by personal check, the registration code will not be sent
  523.   until the check clears.  Do not send cash.  Please allow up to four weeks
  524.   for delivery of your registration code.  Print the registration order form,
  525.   TWASSIST.REG, fill it out, and follow the instructions on the form.
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.                                    Page 9
  540.  
  541.  
  542. ╔════════════════════════════════════════════════════════════════════════════╗
  543. ║ Section  2                   Getting Started                               ║
  544. ╚════════════════════════════════════════════════════════════════════════════╝
  545.  
  546.     TWASSIST keeps game information in a database.  The database can have
  547.   any valid file name but must have a .DAT extension (it will automatically
  548.   be added if you do not provide it).  It is recommended that you use a name
  549.   that identifies the BBS or the game it is for (e.g. NIGHTOWL).  This name,
  550.   with different extensions, will be used to identify the various files for
  551.   this game.  You can specify the database name as an argument on the command
  552.   line or you will be prompted for it.  If the file does not exist you will
  553.   be asked to verify you want to create a new database. You may use directory
  554.   pathnames for the file if it is not in your current directory.  For example:
  555.  
  556.           TWASSIST  NIGHTOWL
  557.           TWASSIST  C:\TW\DATA\NIGHTOWL
  558.  
  559.     If you are creating a new database the program will automatically go to
  560.   the (M)odify Database Menu.  The first thing to do is extract information
  561.   from a capture file.  See the section on the (M)odify Database Menu.
  562.  
  563.     TWASSIST uses a menu hierarchy with related functions grouped together in
  564.   a menu.  Each menu item has a highlighted letter within parenthesis.  To
  565.   execute a particular item enter the highlighted letter and press return (a
  566.   return will not be required if hot keys are enabled).  Some of the reports
  567.   allow output to be sent to a file.  They will have an asterisk (*) on the
  568.   left of the menu item.  To send the output to the file, enter an asterisk
  569.   first and then the highlighted letter for the menu item (e.g. *D).  You
  570.   will be prompted for the file name.  The report will still be displayed on
  571.   the screen if it is being sent to the file.  If you stop the screen output
  572.   (by saying no when asked for more), the output to the file will also be
  573.   stopped.  To get a printed report you can either send the report to a file
  574.   and print the file or specify your printer device (e.g. LPT1) as the
  575.   filename for the report.
  576.  
  577.   WARNING:  If there is a problem in writing to the file (or printer) you
  578.             will see the DOS abort, retry, or fail message.  You should
  579.             select fail (it may be required to do this more than once).  If
  580.             you select abort, DOS will abort the entire program.  TWASSIST
  581.             will have no control over what is happening and all modifications
  582.             in memory that have not been saved to disk will be lost.
  583.  
  584.     Throughout the program there are places where you are asked to provide a
  585.   response.  Default values are shown in brackets.  If multiple choices are
  586.   in brackets they will be separated by a slash (/) with the default shown in
  587.   caps (and highlighted) and the other options in lower case.
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.                                    Page 10
  600.  
  601.  
  602.                          2   Getting Started (contd)
  603.  
  604.  
  605.     Each report is displayed in screens with a prompt asking if you want to
  606.   see more.  The responses are Y for yes, N for no, and C for continuous.  If
  607.   you select continuous, the report will continue without prompting until the
  608.   end is reached.  At the end of the report the program will pause.  This is
  609.   useful if you want to get to the final screen of the report or you want to
  610.   send the entire report to a file and review it later.
  611.  
  612.     A number of the reports show a set of flags for each of the displayed
  613.   sectors.  See (S)ector Reports for a description of these flags.
  614.  
  615.     If a distance can not be computed, either due to an avoid or not having
  616.   warp enough warp information, the distance will be shown as three question
  617.   marks.
  618.  
  619.  
  620.  
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.                                    Page 11
  660.  
  661.  
  662. ╔════════════════════════════════════════════════════════════════════════════╗
  663. ║ Section  3                (M)odify database menu                           ║
  664. ╚════════════════════════════════════════════════════════════════════════════╝
  665.  
  666.     Most of the modifications will be handled automatically by extracting
  667.   information from a capture file.  Functions are also provided to allow you
  668.   to make individual changes to the database.  When making individual changes
  669.   the defaults will be the current values in the database.  If you make a
  670.   mistake and don't want to make changes, you can just accept the defaults.
  671.   If the new values differ from the old values, you will be shown both values
  672.   and prompted if you want modify the database.  This gives you another chance
  673.   to verify your data before the changes are applied.  The default response is
  674.   no so you don't accidently make changes you don't want.  This is to preserve
  675.   what is in the database unless you specifically request it to be changed.
  676.  
  677.     When you quit the (M)odify Database Menu the program will check to see if
  678.   some tables need to be updated.  The computations for determining dead ends
  679.   will take a while if they need to be recomputed and a status bar will show
  680.   the progress.  After the tables are done a flag will be checked to see if
  681.   any changes have been made to the database that have not been saved to the
  682.   file on disk.  You will be prompted if you want to save the changes to the
  683.   file.  If you are making minor changes real time while on-line or are
  684.   experimenting, you may not want to save it right away.  The first save of
  685.   the session will cause the old data file to be renamed as a backup.  If you
  686.   do not save the database the flag will not be reset so each time you quit
  687.   the modify menu you will again be prompted to save the database to the file,
  688.   even if no additional changes were made.  The changes are kept in memory so
  689.   the reports will use the changes even if they are not saved to the file.
  690.   As an extra precaution you will be prompted again when you exit the program.
  691.  
  692.  
  693. ░▒▓█  3.1  █▓▒░  (E)xtract data from a capture file
  694.  
  695.     The (E)xtract data from a capture file function in the modify database
  696.   menu will read various reports from a TW2002 session captured to a file.
  697.   TWASSIST will extract information from the reports and update the database
  698.   accordingly, reporting status to the screen as it progresses.   The
  699.   following reports from TW2002 can be read:
  700.  
  701.     From the main menu:
  702.  
  703.        (V)  View Game Status
  704.        (G)  Show Deployed Fighters
  705.        (K)  Show Deployed Mines
  706.  
  707.     From the computer menu:
  708.  
  709.        (X)  List Current Avoids
  710.             (Also the avoid sectors list displayed when you enter the game.)
  711.  
  712.     From computer interrogation mode (CIM - see below):
  713.  
  714.        (I)  Sector report
  715.        (R)  Port report
  716.  
  717.  
  718.  
  719.                                    Page 12
  720.  
  721.  
  722.               3.1   (E)xtract data from a capture file (contd)
  723.  
  724.  
  725.     WARNING:  There is a bug in v1.03(d) of TW2002 that if you do a CIM R
  726.               report before getting status on a port you will be kicked out
  727.               of the game and back to the BBS.  To prevent this, either port
  728.               at a port or use the computer to get the status of a port.
  729.               It can be any port except a class 0 port.
  730.  
  731.     NOTE:  The location of the class 0 ports are not shown in any of the above
  732.            reports.  You will have to modify the database manually to declare
  733.            their locations (sector 1 is predefined by TWASSIST to be a class 0
  734.            port so you don't need to enter that one).  If the location of the
  735.            stardock is not shown in the View Game Status it will also have to
  736.            be done manually.  Gary Martin has been asked to provide another
  737.            CIM output showing the locations of the class 0 ports and stardock
  738.            in sectors you have explored.
  739.  
  740.     Entering CIM:
  741.  
  742.         CIM is a computer mode in TW2002.  It allows you to interrogate the
  743.       computer for information about sector warps and port information of
  744.       your known universe.  To enter CIM you need to go to the computer
  745.       command prompt in the game and enter ASCII characters 200 thru 205.
  746.       To enter one of these characters hold down the ALT key, type the number
  747.       of the character (e.g. 200) using the keys on the number pad (not the
  748.       upper row!), and then release the ALT key.  To enter CIM you would do:
  749.  
  750.                 ALT down, num pad 200, ALT up
  751.                 ALT down, num pad 201, ALT up
  752.                 ALT down, num pad 202, ALT up
  753.                 ALT down, num pad 203, ALT up
  754.                 ALT down, num pad 204, ALT up
  755.                 ALT down, num pad 205, ALT up
  756.  
  757.         Once in CIM you will see a colon prompt.  CIM will respond to it's
  758.       own set of commands.  Enter an I character to get a report on sector
  759.       warps, an R character to get a report on port information, an F
  760.       character to plot a course similar to using the regular computer
  761.       command, and a Q character to quit CIM.
  762.  
  763.     You can make a capture file of just the above reports or you can capture
  764.   the entire TW2002 session.  The program will find the parts it can use.  It
  765.   is not necessary to separate them into different files.  The extract routine
  766.   will look for certain key phrases or prompts to determine what information
  767.   is in the capture file.  If you just capture the above reports it is a good
  768.   idea to get the prompts before and after just to make sure you didn't miss
  769.   anything.  A number of macros for communications program are provided to
  770.   help capture this information.  Refer to the file TWASTMAC.DOC which came
  771.   with this program for more information.
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.                                    Page 13
  780.  
  781.  
  782.               3.1   (E)xtract data from a capture file (contd)
  783.  
  784.  
  785.     When you extract information from a capture file, you will be prompted
  786.   for the pathname of the capture file.  The file can be any name.  As the
  787.   file is read, the line number of the capture file and a status message will
  788.   be displayed indicating what is being extracted.  At times, messages will
  789.   also be displayed providing information on some of the changes found.
  790.   Warning messages will be displayed if the data is inconsistent with the
  791.   database.  Error messages will be displayed if there are problems reading
  792.   the data from the capture file.  If there are errors while extracting data,
  793.   use a text editor to view the capture file at the line indicated, make any
  794.   changes necessary, and try again to extract data from the capture file.
  795.  
  796.     The messages during an extract or merge will be copied to a log file.
  797.   The log file has the same name as the database but with a .LOG extension.
  798.   This makes it easy to investigate errors or other information.  Setting
  799.   the configuration section for setting append or overwrite for each session.
  800.  
  801.  
  802. ░▒▓█  3.2  █▓▒░  (A)voids
  803.  
  804.     The (A)voids function in the modify database menu will allow you to add
  805.   or remove sectors from the avoids list.  When you select this function, a
  806.   list of the avoids will be displayed.  You will be prompted for a sector
  807.   number and then asked to verify you want this sector added to or removed
  808.   from the avoids.
  809.  
  810.  
  811. ░▒▓█  3.3  █▓▒░  (B)usted
  812.  
  813.     The (B)usted function in the modify database menu will allow you to enter
  814.   or change the busted date for a port.  You will be prompted for a sector
  815.   number.  You will not be allowed to enter a busted date if the sector does
  816.   not have a port defined.  If the sector already has a busted date it will
  817.   be shown and you will be asked if you want to delete or change it.  The
  818.   date the last time port records were cleared of busted names (see (B)usted
  819.   ports in (P)ort Reports) will be shown.  If the last clear date has not
  820.   been set in the database, you will be shown the date 14 days before the
  821.   current date.  Which ever date is shown, you will not be allowed to enter
  822.   any busted date prior to it since those port records would have already
  823.   been cleared.  You will be prompted for the date busted.  Initially the
  824.   default will be the current date.  If you enter a different date, that date
  825.   will be kept as the default for the session until you enter another date.
  826.   This was done because you may be entering a series of busted ports written
  827.   down on scratch paper from an earlier days game play.  After you enter the
  828.   busted date you will be shown the old and new dates and asked if the
  829.   database is to be modified.
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.                                    Page 14
  840.  
  841.  
  842. ░▒▓█  3.4  █▓▒░  (F)ighters
  843.  
  844.     The (F)ighters function in the modify database menu will allow you to
  845.   change the number of deployed fighters in a sector and the fighter mode.
  846.   You will be prompted for a sector number and then be shown the current
  847.   number of fighters there and their mode.  Next you are prompted to enter
  848.   the new number of fighters and the new mode.  After entering the new values,
  849.   you will be shown the old and new values and asked if the database is to be
  850.   modified.
  851.  
  852.  
  853. ░▒▓█  3.5  █▓▒░  (M)ines
  854.  
  855.     The (M)ines function in the modify database menu will allow you to change
  856.   the number of deployed mines in a sector.  You will be prompted for a sector
  857.   number and then shown the current number of mines there.  Next you are
  858.   prompted to enter the new number of mines.  After entering the new value you
  859.   will be shown the old and new values and asked if the database is to be
  860.   modified.
  861.  
  862.  
  863. ░▒▓█  3.6  █▓▒░  (P)orts
  864.  
  865.     The (P)orts function in the modify database menu will allow you to add a
  866.   port to a sector, change the port class, or remove a port from a sector.
  867.   You will be prompted for a sector number.  The current port class (if any)
  868.   for the sector will be displayed.  A list of port classes and the buys and
  869.   sells for the products will be shown.  There is a limit of on Stardock and
  870.   3 class 0 ports.  If the database already has the maximum number for one of
  871.   these port classes, a note will be shown next to that class and that class
  872.   will be disabled for entry.  You will be prompted for the new port class.
  873.   After entering a new port class you will be shown the old and the new
  874.   classes and asked if the database is to be modified.
  875.  
  876.     Since you can not get reports of port status if someone has a fighter
  877.   deployed in the sector (see (U)nknown status ports in (P)ort Reports), you
  878.   will have to manually enter these ports if you come across them.  For
  879.   example, if you see a large density and do a holoscan you may see enemy
  880.   fighters deployed in the sector and a port.  If you do not take out the
  881.   fighters you will not get the port information in the CIM report so extract
  882.   will not know a port is there.  You will have to manually enter the port
  883.   class based on what you saw with the holoscan.
  884.  
  885.   NOTE:  Any port whose class is entered or changed manually will be flagged
  886.          as having unknown status.  The status will be changed to known if
  887.          the information appears in a CIM report.  The only exceptions to
  888.          this is changing from a class 8 to a class 9 Stardock port or
  889.          vice-versa.  The CIM report for a class 8 and class 9 are the same
  890.          so the information is still valid.
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.                                    Page 15
  900.  
  901.  
  902. ░▒▓█  3.7  █▓▒░  (W)arps
  903.  
  904.     The (W)arps function in the modify database menu will allow you to enter
  905.   or change the warps of a sector.  You will be prompted for a sector number
  906.   and shown the current warps (if any).  Enter the new warps on a single line
  907.   separating them with spaces.  Entering the number 0 (as the first and only
  908.   warp) will cause all warps to be deleted.  After entering the warps you will
  909.   be shown the old and new warps.  If the sector is explored a message will be
  910.   displayed saying that if you save the warp changes the sector will be marked
  911.   as unexplored.  Only warp information read in a CIM report while extracting
  912.   from a capture file will mark a sector as explored.  You will then be asked
  913.   if the database is to be modified.
  914.  
  915.  
  916. ░▒▓█  3.8  █▓▒░  (N)otes
  917.  
  918.     The (N)otes function in the modify database menu will allow you to enter,
  919.   delete, or change a note for a sector.  You can have one note for each
  920.   sector (more notes take more memory and more disk space).  Each note can
  921.   have up to 120 characters.  The first 6 of these characters are taken up by
  922.   a date which is automatically inserted.  The date is of the form "mm/dd "
  923.   and is the date read from the system clock at the time you enter the note.
  924.  
  925.     You will be prompted for a sector number.  If there is no note for the
  926.   sector you will be asked if you want to create one.  If there is a note it
  927.   will be displayed and you will be asked if you want to delete or change it.
  928.   After entering the note you will be shown the old note and the new note and
  929.   asked if the database is to be modified.
  930.  
  931.     There are several note features that are included for your convenience.
  932.   These include being able to backspace over the date if it is not wanted or
  933.   more space is desired, backspacing up to the previous line, automatic word
  934.   wrap when a note is viewed, and more.
  935.  
  936.  
  937. ░▒▓█  3.9  █▓▒░  (G)ame information
  938.  
  939.     The (G)ame information function in the modify database menu will allow
  940.   you to change the game version, game registration status, the number of
  941.   planets, and the number of citadels.  The game version and registration
  942.   status are used to determine if the shipyards are open in the Stardock.
  943.   The number of planets and citadels is for your information only.  They are
  944.   not used in this version of TWASSIST.  The status date shown in the game
  945.   information section of the database summary is also for your information
  946.   only.  It can not be changed manually but if you modify any of the game
  947.   information parameters it will be changed to say "Manually modified on
  948.   MM/DD".  This is to indicate the game information in the summary was not
  949.   extracted from a configuration status report in a capture file.
  950.  
  951.     When you first select game information, you will be given a list of the
  952.   things you can modify and their current values.  Select the one you wish to
  953.   modify.
  954.  
  955.  
  956.  
  957.  
  958.  
  959.                                    Page 16
  960.  
  961.  
  962.                       3.9   (G)ame information (contd)
  963.  
  964.  
  965.     If you select (V)ersion, you will be prompted for the new version.  You
  966.   will not be able to enter a number 2.0 or higher.  Do not append any letters
  967.   to the game version (enter 1.03 not 1.03d).  After entering the new version
  968.   you will be shown the old and new values and asked if you want to modify
  969.   the database.
  970.  
  971.     If you select (R)egistered, it will automatically toggle to the opposite
  972.   value (since there is only one other choice for a YES/NO value).  You will
  973.   be shown the old and new values and asked if the database is to be modified.
  974.  
  975.     If you select (P)lanets, you will be asked for the new number.  Since
  976.   Terra must always exist the minimum value is 1.  When you change the number
  977.   of planets, the citadel percentage will be recalculated so the number of
  978.   citadels remains the same.  If you lower the number of planets so that the
  979.   number of citadels exceeds the maximum allowed, the number of citadels will
  980.   be lowered to the maximum and the percentage calculated accordingly.  After
  981.   entering the new value you will be shown the old and new values along with
  982.   the changes to the citadel numbers.  You will then be asked the database is
  983.   to be modified.
  984.  
  985.     If you select (C)itadels, you will be asked for the new percentage.  The
  986.   maximum number of citadels is one less than the number of planets (since
  987.   Terra can not have a citadel) and the maximum percentage will be calculated
  988.   based on this number.  You will not be able to enter a percentage that is
  989.   impossible based on the number of planets.  For example, with 5 planets you
  990.   can not have 50% citadels.  If the value is impossible, two possible values
  991.   just above and just below the value you entered will be shown and you will
  992.   be prompted to reenter the new percentage. After entering the new percentage
  993.   you will be shown the old and new values and asked if the database is to be
  994.   modified.
  995.  
  996.     If you select (D)ays, you will be asked for the number of days the game
  997.   has been running and the corresponding month and day.  You will then be
  998.   shown the old game days and the new information and asked if the database
  999.   is to be modified.  It is not recommended you change the game days.  This
  1000.   information is used for determining the port busts clearing cycle.  Once
  1001.   the cycle is known TWASSIST will automatically keep it up to date and it
  1002.   will be verified every time a View Game Status is read from a capture file.
  1003.   Modify the (D)ays only if you want to the cycle to be calculated, because
  1004.   you have not had a View Game Status in a capture file, or if you think the
  1005.   cycle may have changed and don't have a new View Game Status.
  1006.  
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012.  
  1013.  
  1014.  
  1015.  
  1016.  
  1017.  
  1018.  
  1019.                                    Page 17
  1020.  
  1021.  
  1022. ░▒▓█  3.10  █▓▒░  (S)hip information
  1023.  
  1024.     The (S)hip information function in the modify database menu allows you to
  1025.   change the ship flags shown in the database summary.  The Trans(w)arp flag
  1026.   is registered only and is used by some of the reports to determine if
  1027.   transwarp information should be computed and displayed.  This flag has no
  1028.   affect on the (T)ranswarp route to a sector in (R)oute Reports, which can
  1029.   always be used.  Two of the port reports, (P)aired ports and (0) Closest
  1030.   place to buy class 0 items, and the custom reports will use the flag.  The
  1031.   transwarp information in these reports is an extra, all the other informa-
  1032.   tion in these reports will still be available.  The transwarp computations
  1033.   can be lengthy.  If your ship does not have transwarp, or if you have a
  1034.   slower computer and don't want this information all the time, set the
  1035.   transwarp flag to no.
  1036.  
  1037.     The Twarp to toll (f)ighter flag is used to determine if a toll fighter
  1038.   can be used as a destination for transwarping.  People who leave toll
  1039.   fighters around and don't mind transwarping to one can set this flag to
  1040.   yes.  Others that don't like the idea of someone paying the toll and
  1041.   leaving 99 mines behind for them to transwarp into may prefer to set this
  1042.   to no.  This depends on the kind of competition in your game and your
  1043.   personal preferences.  The default value is no.  Offensive and defensive
  1044.   fighters will automatically be used for transwarping.
  1045.  
  1046.     Both of these flags are just yes/no values.  When you select either one
  1047.   it will automatically toggle to the opposite value.  You will be shown the
  1048.   old and new values and asked if the database is to be modified.
  1049.  
  1050.  
  1051. ░▒▓█  3.11  █▓▒░  Merge another (T)rader's database
  1052.  
  1053.     The Merge another (T)rader's database function in the modify database
  1054.   menu will read in another TWASSIST database and merge the information into
  1055.   yours.  Traders in a corporation or even individual traders working together
  1056.   can share their knowledge of the universe.  TWASSIST relies heavily on warp
  1057.   information.  The more sectors in the universe you have warps for, the more
  1058.   information TWASSIST can provide and the more accurate it can be.  Merging
  1059.   provides a very easy way to fill in the information on the universe.
  1060.  
  1061.     Only sector warps, port classes, and notes are merged.  Other information
  1062.   like deployed fighters, deployed mines, and game information may not be
  1063.   relevant to you and you can easily get this information from the reports in
  1064.   the game.  The idea is to get information on unexplored sectors to fill in
  1065.   the gaps in your information and to check their notes to see if there is
  1066.   something of value in them.  When warps for a sector are copied, the sector
  1067.   will still be marked unexplored to agree with the game.  It will be
  1068.   considered unexplored with warps (see (S)ector Reports).  Ports copied will
  1069.   be marked as unknown status (see (U)known status ports in (P)ort Reports).
  1070.   You will know the class of the port but not the product quantities.  The
  1071.   paired ports will not be able to compute a factor on it and the custom
  1072.   reports will not be able to do any comparisons on the quantities.  If you
  1073.   explore the sector and the port shows up in a CIM, it will then be marked
  1074.   as known status.
  1075.  
  1076.  
  1077.  
  1078.  
  1079.                                    Page 18
  1080.  
  1081.  
  1082.               3.11  Merge another (T)rader's database  (contd)
  1083.  
  1084.  
  1085.     When you merge databases you will be prompted for the filename of the
  1086.   database to read.  TWASSIST will load the database into memory and then
  1087.   start the merge.  During the merge, sector warp information and port
  1088.   classes will be read from both databases.  If the information exists in
  1089.   the other database but not in yours it will be copied into yours.  If the
  1090.   information exists in both databases it will be compared.  If both
  1091.   databases compare nothing happens.  If there is a difference you will see
  1092.   a warning message telling what type of difference was found and the action
  1093.   taken.  After going through all the sectors the notes will be merged.  If
  1094.   the same note exists in both databases (maybe from a previous merge)
  1095.   nothing happens.  If the other database has a note for a sector and your
  1096.   database does not or the notes are different, the notes will be displayed
  1097.   and you will be asked whether or not you want to copy their note.  After
  1098.   the merge is complete, status information will be displayed telling you
  1099.   how many sectors with warps, ports, and notes were copied from the other
  1100.   database.
  1101.  
  1102.     The messages during an extract or merge will be copied to a log file.
  1103.   The log file has the same name as the database but with a .LOG extension.
  1104.   This makes it easy to investigate errors or other information.  Setting
  1105.   the configuration section for setting append or overwrite for each session.
  1106.  
  1107.  
  1108. ░▒▓█  3.12  █▓▒░  Strip database for (O)ther trader
  1109.  
  1110.     This function creates a special database with some data from the current
  1111.   database but not all of it.  It is useful if you want to trade databases
  1112.   with a partner that is not in your corporation.  You don't necessarily want
  1113.   to give another player your fighter and mine locations and all your notes.
  1114.  
  1115.     A stripped database will include information from the View Game Status
  1116.   except for the Stats Date, you may not want them to know when you were
  1117.   on-line.  All sector warps will be included along with explored/unexplored
  1118.   flags as they are necessary for TWASSIST to determine how to merge the
  1119.   data.  The only port information included is the port class.  The busted
  1120.   dates may be optionally included in case you are trading busted locations.
  1121.   For notes you can specify to include all notes, none of the notes, or
  1122.   individually specify each note.
  1123.  
  1124.     After specifying the optional information to be included, select (C)reate
  1125.   stripped database.  You will be prompted for the filename.  At this time
  1126.   the information will be prepared as specified and you will be prompted for
  1127.   the notes if you wanted to specify each note individually.  The stripped
  1128.   database will then be saved to the file.
  1129.  
  1130.  
  1131.  
  1132.  
  1133.  
  1134.  
  1135.  
  1136.  
  1137.  
  1138.  
  1139.                                    Page 19
  1140.  
  1141.  
  1142. ╔════════════════════════════════════════════════════════════════════════════╗
  1143. ║ Section  4                  (D)atabase summary                             ║
  1144. ╚════════════════════════════════════════════════════════════════════════════╝
  1145.  
  1146.     This report provides a one screen summary of the database.  At a glance
  1147.   you can see how much you know of the universe, what info the database
  1148.   contains, and how the database flags are set.
  1149.  
  1150.     If you have manually entered warp information on a sector or merged
  1151.   another trader's database, you may see a number next to the unexplored
  1152.   sector count indicating how many have warps (see (S)ector Reports).  If you
  1153.   add up this number with warps and the explored sector count, the total is
  1154.   the number of sectors you have warp information on.  These are the sectors
  1155.   that routes and distances can be plotted through.
  1156.  
  1157.  
  1158.  
  1159.  
  1160.  
  1161.  
  1162.  
  1163.  
  1164.  
  1165.  
  1166.  
  1167.  
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179.  
  1180.  
  1181.  
  1182.  
  1183.  
  1184.  
  1185.  
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.  
  1193.  
  1194.  
  1195.  
  1196.  
  1197.  
  1198.  
  1199.                                    Page 20
  1200.  
  1201.  
  1202. ╔════════════════════════════════════════════════════════════════════════════╗
  1203. ║ Section  5                       (N)otes                                   ║
  1204. ╚════════════════════════════════════════════════════════════════════════════╝
  1205.  
  1206.  
  1207. ░▒▓█  5.1  █▓▒░  (V)iew notes
  1208.  
  1209.     The (V)iew notes report will display all notes in the database.  The
  1210.   sector number and the note will be displayed.
  1211.  
  1212.  
  1213. ░▒▓█  5.2  █▓▒░  (E)dit notes
  1214.  
  1215.     The (E)dit notes functions is the same as the (N)otes function in the
  1216.   Modify Database menu.  Refer to that section for information.
  1217.  
  1218.  
  1219. ░▒▓█  5.3  █▓▒░  (S)earch notes   <Registered only>
  1220.  
  1221.     The (S)earch notes report allows you to specify a string of text, and all
  1222.   notes containing that string will be displayed.  You will be prompted for a
  1223.   search string.  The search is case insensitive (so 'a' matches 'a' or 'A').
  1224.   After entering the string, the database will be searched for notes that
  1225.   contain the string.  The sector numbers and notes will be displayed, with
  1226.   the matching string highlighted so you can see where the match was made.
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244.  
  1245.  
  1246.  
  1247.  
  1248.  
  1249.  
  1250.  
  1251.  
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.  
  1259.                                    Page 21
  1260.  
  1261.  
  1262. ╔════════════════════════════════════════════════════════════════════════════╗
  1263. ║ Section  6                    (P)ort Reports                               ║
  1264. ╚════════════════════════════════════════════════════════════════════════════╝
  1265.  
  1266.     Some of the port reports will show flag settings for the sectors.  See
  1267.   (S)ector Reports for more information.
  1268.  
  1269.  
  1270. ░▒▓█  6.1  █▓▒░  (P)aired ports
  1271.  
  1272.     The (P)aired ports report will determine where adjacent ports exist that
  1273.   have complimentary buys and sells of products.  These are good locations
  1274.   for trading since you can move back and forth between these ports with a
  1275.   minimum of turns and therefore can do more trades.  Ports with higher
  1276.   quantities to buy/sell give better prices and you can spend more turns
  1277.   there trading and less turns moving to a new pair.
  1278.  
  1279.     The pairs are divided into types of products they will trade.  Equipment
  1280.   gives the highest amount of profit, organics is second, and fuel is third.
  1281.   You can select from three categories of trades you want displayed.  The
  1282.   number of pairs found that match each category will be shown.  Select the
  1283.   type of pairs you want displayed.  The default is trading equipment and
  1284.   organics since this is the most profitable.  If you have not explored much
  1285.   of the universe and only a few of these pairs are found you may want to
  1286.   select another category so you have more pairs to choose from.  Also, if
  1287.   there are lots of trader's draining the ports (they take a while to
  1288.   regenerate) all the equipment and organics pairs may not have much for
  1289.   quantities.  Selecting another category may provide a few good places to
  1290.   trade.
  1291.  
  1292.     You will be prompted for a sector number to calculate distances from.
  1293.   The pairs will be shown with the sector numbers and distance to the pair.
  1294.   If the program is registered and the ship transwarp flag is set (see (S)hip
  1295.   information in the (M)odify Database Menu), transwarp calculations will be
  1296.   made to determine the closest fighter to each paired port.  If there is a
  1297.   benefit to transwarping, information will be displayed showing the number
  1298.   of turns to the pair, the number of hops to the fighter, and the location
  1299.   of the fighter.  A factor that is a relative guide to the credit making
  1300.   potential of trading at the pair is calculated.  It can be used to compare
  1301.   the different pairs.  The factor times 100 is roughly the amount of profit
  1302.   that can be made at the pair (e.g. factor of 965 means a profit potential
  1303.   of roughly 96,500 credits).  Due to variations within the game an exact
  1304.   number can not be calculated.  If any of the ports in the pair have unknown
  1305.   product status (see (U)known status ports in (P)ort Reports) the factor will
  1306.   be zero.  Quantities of the products at each of the ports is also shown.
  1307.   The output is sorted by distance to the pair.  If transwarp calculations are
  1308.   made and the transwarp turns is less than the distance, it will be used for
  1309.   the sort.  In this case you may see pairs with a higher distance mixed in
  1310.   with pairs of lower distance because of the lower number of transwarp turns.
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317.  
  1318.  
  1319.                                    Page 22
  1320.  
  1321.  
  1322. ░▒▓█  6.2  █▓▒░  (N)earest ports
  1323.  
  1324.     The (N)earest ports report will show the locations of all ports, sorted by
  1325.   distance from the reference sector.  The report will be like the (N)earest
  1326.   sectors report in (S)ector Reports except only sectors with ports will be
  1327.   shown.
  1328.  
  1329.  
  1330. ░▒▓█  6.3  █▓▒░  (U)known status ports   <Registered only>
  1331.  
  1332.     Unknown status ports are ports where you do not have updated information
  1333.   on the amount of the products available from the CIM port report.  This can
  1334.   be caused by three things:
  1335.  
  1336.       (1)  You have not explored the sector.  You may have manually entered
  1337.            the port class based on information from another trader or it was
  1338.            merged in from another traders database.  You will see the
  1339.            unexplored sector flag for these ports.
  1340.  
  1341.       (2)  There are deployed fighters in the sector, either the Ferrengi or
  1342.            another player.  You can get port status through your own personal
  1343.            or corporate fighters but not through other fighters.
  1344.  
  1345.       (3)  The port has been destroyed.  In this case you should remove the
  1346.            port from the database.
  1347.  
  1348.     The output of this report will look like the (N)earest ports report except
  1349.   only ports with unknown status will be shown.
  1350.  
  1351.  
  1352. ░▒▓█  6.4  █▓▒░  (B)usted ports
  1353.  
  1354.     The (B)usted ports report will display the ports that have busted dates
  1355.   set.  If the maintenance cycle is known (from information extract from a
  1356.   View Game Status report) the dates port records were last cleared of busted
  1357.   names and the date they will be cleared next will be displayed.  A list of
  1358.   sector numbers, port types, and the dated busted will be shown.
  1359.  
  1360.     Each time you enter the program the date will be checked to see if it is
  1361.   after the next clear date.  If it is, all busted port dates up to but not
  1362.   including the clear date will be cleared from the database and the database
  1363.   modified flag will be set. The program plays it safe with regard to clearing
  1364.   the busted dates.  They are not cleared on the actual clear date because you
  1365.   may be playing before the game's maintenance is run.  When they are cleared
  1366.   on the next day the busted dates on the last clear date on not cleared
  1367.   because you may have played after maintenance.  It is better to be on the
  1368.   safe side than to go to a port you were busted at.  If you play after
  1369.   maintenance on the clear date you can always ignore the busted flags.  If
  1370.   you play before maintenance on the clear date, you can always delete those
  1371.   busted dates manually.  You can tell when maintenance is run by examining
  1372.   the daily log in the game.  The line that says the "Ferrengi moved at" is
  1373.   when the maintenance was run.
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.                                    Page 23
  1380.  
  1381.  
  1382. ░▒▓█  6.5  █▓▒░  (0) Closest place to buy class 0 items
  1383.  
  1384.     This report will give a tabular display of the class 0 ports and their
  1385.   distances.  The stardock will also be included if the information in the
  1386.   game status (TW2002 version and registration status) indicate the shipyards
  1387.   are open.  If the program is registered and the ship transwarp flag set,
  1388.   additional columns will show the nearest fighter, turns, and hops to
  1389.   transwarp to each of these ports.
  1390.  
  1391.  
  1392.  
  1393.  
  1394.  
  1395.  
  1396.  
  1397.  
  1398.  
  1399.  
  1400.  
  1401.  
  1402.  
  1403.  
  1404.  
  1405.  
  1406.  
  1407.  
  1408.  
  1409.  
  1410.  
  1411.  
  1412.  
  1413.  
  1414.  
  1415.  
  1416.  
  1417.  
  1418.  
  1419.  
  1420.  
  1421.  
  1422.  
  1423.  
  1424.  
  1425.  
  1426.  
  1427.  
  1428.  
  1429.  
  1430.  
  1431.  
  1432.  
  1433.  
  1434.  
  1435.  
  1436.  
  1437.  
  1438.  
  1439.                                    Page 24
  1440.  
  1441.  
  1442. ╔════════════════════════════════════════════════════════════════════════════╗
  1443. ║ Section  7                   (S)ector Reports                              ║
  1444. ╚════════════════════════════════════════════════════════════════════════════╝
  1445.  
  1446.     A number of the reports display flags of information about the sectors.
  1447.   The flags are:
  1448.  
  1449.                   BD  SL
  1450.        U A B M Fx DEn SD
  1451.        ^ ^ ^ ^ ^  ^   ^
  1452.        │ │ │ │ │  │   └───── SD  = Sector is Stardock.
  1453.        │ │ │ │ │  │          SL  = Sector is in space lane.
  1454.        │ │ │ │ │  │
  1455.        │ │ │ │ │  └───────── DEn = Sector is a dead end of depth 'n'
  1456.        │ │ │ │ │             BD  =  Sector has a back door.  There is one or
  1457.        │ │ │ │ │                   more one way warps into the sector.
  1458.        │ │ │ │ │
  1459.        │ │ │ │ └──────────── Fx  = Deployed fighters where 'x' is the mode,
  1460.        │ │ │ │                     O = Offensive, D = Defensive, T = Toll.
  1461.        │ │ │ │
  1462.        │ │ │ └────────────── M   = Deployed mines.
  1463.        │ │ │
  1464.        │ │ └──────────────── B   = Port has busted date.
  1465.        │ │
  1466.        │ └────────────────── A   = Sector is an avoid.
  1467.        │
  1468.        └──────────────────── U   = Sector is unexplored.
  1469.  
  1470.     TWASSIST categorizes sectors a number of ways.  Like TW2002, there are
  1471.   explored and unexplored sectors.  TWASSIST further divides the unexplored
  1472.   sectors into other categories.  Some of the following descriptions for the
  1473.   sector reports will use the diagram below for an example to aid in
  1474.   explaining the different categories.
  1475.  
  1476.             100 <────> 200 <────> 300 <────> 400 <────> 500
  1477.           player 1                                    player 2
  1478.  
  1479.           Player 1 has explored sector 100 but not the others.
  1480.           Player 2 has explored sector 500 but not the others.
  1481.  
  1482.  
  1483. ░▒▓█  7.1  █▓▒░  (F)ull report on a sector
  1484.  
  1485.     The (F)ull report on a sector gives a detailed display of all the
  1486.   information known about a sector.  Included will be the warps with one
  1487.   ways out identified, back doors, flag settings, various parameters, port
  1488.   information, and any note.
  1489.  
  1490.  
  1491.  
  1492.  
  1493.  
  1494.  
  1495.  
  1496.  
  1497.  
  1498.  
  1499.                                    Page 25
  1500.  
  1501.  
  1502. ░▒▓█  7.2  █▓▒░  (N)earest sectors
  1503.  
  1504.     The (N)earest sectors report will show each sector, sorted by distance
  1505.   from the current sector.  The report will show the sector number, the
  1506.   distance to the sector, and the flags for that sector.  If the sector has a
  1507.   port it will also show the port type and the product status.  Any note for
  1508.   the sector will also be shown.
  1509.  
  1510.  
  1511. ░▒▓█  7.3  █▓▒░  (U)nexplored sectors
  1512.  
  1513.     The (U)nexplored sectors report is the same as the (N)earest sectors
  1514.   report except it only shows those sectors that are unexplored.  This can be
  1515.   used to find a close sector to explore.  Maybe you have a few extra turns
  1516.   left after trading.
  1517.  
  1518.     If you merge databases with another trader, this is the last report to
  1519.   use to find sectors to explore.  Once you have information on the entire
  1520.   universe there will be no need to continue to merge databases but you may
  1521.   have some sectors you have not personally explored and can not get port
  1522.   information on.  To get the most use out of an ether probe, send it to a
  1523.   dead end sector some distance away.  Choose the dead ends closer to the end
  1524.   of the report.  By sending the probe some distance away you have a greater
  1525.   chance of going through more unexplored sectors.  You also want to explore
  1526.   the entire tunnel with one probe instead of stopping part way in and needing
  1527.   another probe later to get the rest.  After getting the dead ends, work on
  1528.   the rest of the sectors.
  1529.  
  1530.  
  1531. ░▒▓█  7.4  █▓▒░  Une(x)plored clusters   <Registered only>
  1532.  
  1533.     The Une(x)plored clusters report can tell you where you have groups of
  1534.   unexplored sectors.  The report will show each sector number that has
  1535.   adjacent unexplored sectors and the number of unexplored sectors.  It will
  1536.   also show the number of those unexplored sectors that have no warp informa-
  1537.   tion (see (W)ithout warps in Sector Reports).  The report is sorted by the
  1538.   number of adjacent unexplored sectors in descending order.  The sector with
  1539.   the most adjacent unknown information is at the top.
  1540.  
  1541.     These unexplored clusters are a good place to do a holoscan since one turn
  1542.   with the holoscanner can explore a number of sectors.  This is especially
  1543.   useful if the sector has a good port that could be part of a trade pair.  If
  1544.   a sector has a port that is buying organics and selling equipment or vice
  1545.   versa, and has a number of unexplored sectors adjacent, there is a good
  1546.   chance you may find a matching port.
  1547.  
  1548.  
  1549.  
  1550.  
  1551.  
  1552.  
  1553.  
  1554.  
  1555.  
  1556.  
  1557.  
  1558.  
  1559.                                    Page 26
  1560.  
  1561.  
  1562. ░▒▓█  7.5  █▓▒░  Un(k)nown sectors   <Registered only>
  1563.  
  1564.     The Un(k)nown sector report is not the same as the unexplored sector
  1565.   report from the computer in the game.  This unknown sector report will show
  1566.   sectors which have no location information in the database.  They have no
  1567.   known warps and no other sector has a warp to them.  In the above diagram,
  1568.   player 1 would show sectors 300, 400, and 500 as unknown.  Sector 200 is not
  1569.   considered unknown because sector 100 has a warp to it.  For player 2, the
  1570.   unknown sectors are 100, 200, and 300.  If the two players merged their
  1571.   databases, both players would have warp information for sectors 100 and 500,
  1572.   and sectors 200 and 400 have warps to them.  The only unknown sector is 300.
  1573.  
  1574.     This is useful for sending ether probes. If you used the unexplored sector
  1575.   report from the game computer you could pick sectors that are adjacent to
  1576.   explored sectors, especially after you have explored a good portion of the
  1577.   universe.  By using this unknown sector report you know the probe has to go
  1578.   through at least one other unexplored sector to get to it.  You are more
  1579.   likely to get multiple unexplored sectors in the path so the ether probe
  1580.   provides more information.  Use the computer on-line in the game to go plot
  1581.   paths (F command) to these unknown sectors and pick ones that have more
  1582.   unexplored sectors in the paths as the ether probe target.
  1583.  
  1584.     If you are merging databases with another trader you can use this report
  1585.   to maximize your explorations/probes.  These sectors are unknown to both
  1586.   traders so you can get the most benefit from exploring these sectors.
  1587.  
  1588.   NOTE:  Since there is no CIM output for determining the location of the
  1589.          class 0 ports you should be on the lookout for their locations in
  1590.          the probe outputs.  Make use of your scroll back buffer or capture
  1591.          the entire session and review it later off-line.
  1592.  
  1593.  
  1594. ░▒▓█  7.6  █▓▒░  (W)ithout warps   <Registered only>
  1595.  
  1596.     The (W)ithout warps reports is similar to the (U)nexplored sectors report
  1597.   except it shows only those sectors that have no warp information.  For those
  1598.   who have never modified the database to add warps for a sector and never
  1599.   merged databases from another trader, then this report will be just like the
  1600.   unexplored sector report.
  1601.  
  1602.     In the above example diagram, player 1 has four unexplored sectors.  If
  1603.   player 1 merged databases from player 2 then sector 500 would have warp
  1604.   information even though it is unexplored.  The (W)ithout warps report will
  1605.   only report sectors 200, 300, and 400.
  1606.  
  1607.     This is useful when merging databases and you are getting towards the end
  1608.   of exploring the universe.  Once you have explored the universe to eliminate
  1609.   the unknown sectors, you may still have sectors where you do not have warp
  1610.   information.  In the above diagram, let's say player 1 wants to explore
  1611.   unknown sector 300, so a probe is sent from 100 through 200 to 300.  With
  1612.   the data for sector 500 from player 2, that leaves only sector 400 without
  1613.   warp information.  This is a sector that is unexplored by both players.
  1614.  
  1615.  
  1616.  
  1617.  
  1618.  
  1619.                                    Page 27
  1620.  
  1621.  
  1622. ░▒▓█  7.7  █▓▒░  (D)ead end sector analysis
  1623.  
  1624.     The (D)ead end sectors analysis shows the tunnels out of a dead end
  1625.   sector.  A dead end sector is one that has only one sector that leads to it
  1626.   and it's only way out is to that same sector.  This report shows the depths
  1627.   of the tunnels of dead ends in the universe and how many at each depth.
  1628.   You may then select a desired depth for more information on those sectors.
  1629.   The report will display the sector number and port type (if any) for each
  1630.   dead end of this depth.  Each sector in the tunnel will be shown in the
  1631.   same way until the entrance/exit of the tunnel is reached.
  1632.  
  1633.     You can not go through a dead end sector on the way to somewhere.  You can
  1634.   only get to it by setting it as the destination.  If the sector has multiple
  1635.   ways out or a way out that is not the same as the only way in, then it is
  1636.   possible to pass through the sector while going some place else and is
  1637.   therefore not classified as a dead end.  As a result, dead end sectors are
  1638.   not as easily explored.  This is usually a good place for building planets
  1639.   and hiding when you don't have a cloak.  A deeper tunnel is less likely to
  1640.   get explored and provides more room for defenses.  It also gives your
  1641.   opponents more room for blocking you in and takes more turns to get in and
  1642.   out each time unless you have a transwarp.
  1643.  
  1644.  
  1645. ░▒▓█  7.8  █▓▒░  (C)luster dead end analysis   <Registered only>
  1646.  
  1647.     The (C)luster dead end analysis will look for a sector that has no back
  1648.   doors and all but one warp leads to a dead end.  The one warp is the
  1649.   entrance/exit to the cluster.  To find these groups it is necessary to
  1650.   explore all those DE1s that most people do not worry about.  For example,
  1651.   consider the following layout of sectors (all two way warps):
  1652.  
  1653.                                    500
  1654.                                     │
  1655.                      100 ── 200 ── 300 ── 400 entrance/exit
  1656.                                     │
  1657.                                    600
  1658.  
  1659.     If sector 500 or 600 is unexplored you can not tell if this is a dead end
  1660.   cluster.  After exploring 40% or more of the universe, use the unexplored
  1661.   clusters report and holoscan.  You will find a number of them are dead ends
  1662.   one deep and may be part of a dead end cluster.  In the above example with
  1663.   all the sectors explored, sector 300 will be detected as being a dead end
  1664.   cluster.  You may even find a sector that has 4 DE1s with a single way in
  1665.   and out.
  1666.  
  1667.     Dead end clusters may be a good place to build.  This will depend on your
  1668.   competition and how they search for other players planets (and whether or
  1669.   not they are using a utility like this one).  You may have the benefit of a
  1670.   number of close ports and still have a defendable location.  You will also
  1671.   find dead ends that are a lot deeper than anyone may think they are.  I have
  1672.   seen a dead end cluster with a dead end 3 deep and the entrance/exit to the
  1673.   cluster was also 3 deep.  That means the dead end was really 6 sectors from
  1674.   a through way.
  1675.  
  1676.  
  1677.  
  1678.  
  1679.                                    Page 28
  1680.  
  1681.  
  1682. ╔════════════════════════════════════════════════════════════════════════════╗
  1683. ║ Section  8                   (R)oute Reports                               ║
  1684. ╚════════════════════════════════════════════════════════════════════════════╝
  1685.  
  1686.  
  1687. ░▒▓█  8.1  █▓▒░  (N)ormal route
  1688.  
  1689.     The (N)ormal route report will determine the distance to a destination
  1690.   and the sectors travelled through.  The first sector listed will be the
  1691.   starting location and the last sector listed will be the destination.  Each
  1692.   sector will be shown in the order they are travelled through to reach the
  1693.   destination.  The output format will be like the (N)earest sectors report
  1694.   in the Sector Reports menu.  At the end of the list the distance will be
  1695.   given.  You will then be prompted on whether or not you want to display the
  1696.   return path.
  1697.  
  1698.  
  1699. ░▒▓█  8.2  █▓▒░  (T)ranswarp route
  1700.  
  1701.     The (T)ranswarp route report is similar to the normal route report except
  1702.   it will look at fighter locations and determine if fewer turns could be used
  1703.   by transwarping.  If transwarping takes fewer turns it will display the
  1704.   route with the first sector the starting location, the second sector the
  1705.   fighter to transwarp to, followed by the sectors travelled through from the
  1706.   fighter, and the last sector will be the destination.  At the end of the
  1707.   list the turns, hops, and fighter location will be given.  If there is no
  1708.   benefit to transwarping a message will say so and a route using normal
  1709.   movement will be shown.
  1710.  
  1711.  
  1712.  
  1713.  
  1714.  
  1715.  
  1716.  
  1717.  
  1718.  
  1719.  
  1720.  
  1721.  
  1722.  
  1723.  
  1724.  
  1725.  
  1726.  
  1727.  
  1728.  
  1729.  
  1730.  
  1731.  
  1732.  
  1733.  
  1734.  
  1735.  
  1736.  
  1737.  
  1738.  
  1739.                                    Page 29
  1740.  
  1741.  
  1742. ░▒▓█  8.3  █▓▒░  (S)pace lanes
  1743.   
  1744.     The (S)pace lanes report will determine the routes for each of the eight
  1745.   space lanes.  These are the routes the Feds will clear all fighters and
  1746.   mines from during maintenance.  The following diagram shows what the space
  1747.   lanes are:
  1748.  
  1749.        ┌─────────┐        
  1750.        │    1    │        ┌────────────────┐
  1751.        │   Sol   ├────────┤ Stargate Alpha ├───────────────────┐
  1752.        │ Class 0 ├────────┤    Stardock    ├────────────────┐  │
  1753.        └─────────┘        └──────┬──┬──────┘                │  │
  1754.                                  │  │                       │  │
  1755.                                  │  │                       │  │
  1756.                           ┌──────┴──┴──────┐          ┌─────┴──┴───────┐
  1757.                           │ Alpha Centauri ├──────────┤     Rylos      │
  1758.                           │    Class 0     ├──────────┤    Class 0     │
  1759.                           └────────────────┘          └────────────────┘
  1760.  
  1761.     The (S)pace lanes report has output in two parts.  First are the actual
  1762.   routes.  On the left of the screen is the starting location of each of the
  1763.   routes, and on the right is the final location.  In between, the sectors on
  1764.   the route are listed.  The second part of the output is a listing of the
  1765.   sectors in all the space lanes listed in numerical order.  The provides an
  1766.   easy method of determining if a sector is in a space lane.
  1767.  
  1768.     TWASSIST can only calculate the space lanes based on the information you
  1769.   have about the universe.  If you do not have the actual paths explored, the
  1770.   routes calculated will not be the same as in the game.  Use the computer in
  1771.   the game to show each route (without any avoids but save them so you can
  1772.   reenter them) and see if you have explored every sector necessary for
  1773.   TWASSIST to show you the true space lanes.
  1774.  
  1775.  
  1776.  
  1777.  
  1778.  
  1779.  
  1780.  
  1781.  
  1782.  
  1783.  
  1784.  
  1785.  
  1786.  
  1787.  
  1788.  
  1789.  
  1790.  
  1791.  
  1792.  
  1793.  
  1794.  
  1795.  
  1796.  
  1797.  
  1798.  
  1799.                                    Page 30
  1800.  
  1801.  
  1802. ╔════════════════════════════════════════════════════════════════════════════╗
  1803. ║ Section  9         (C)ustom Reports   <Registered only>                    ║
  1804. ╚════════════════════════════════════════════════════════════════════════════╝
  1805.  
  1806.     The entire custom reports menu is registered only.
  1807.  
  1808.     The (C)ustom reports provides a flexible way of defining your own reports.
  1809.   You can select the type of report:  paired ports, single ports, or any
  1810.   sector.  For each report you can specify various parameters that must be met
  1811.   for the pair/port/sector to be matched and shown in the report.  You can
  1812.   also specify various ways of sorting the output.  Up to 6 reports can be
  1813.   defined, with a title for each.  The custom reports are stored in a file
  1814.   with the same name as the datafile but with a .CUS extension.  This allows
  1815.   you to create different reports for each game for the style of play you are
  1816.   using for that game.  Here are some things custom reports have been used
  1817.   for:
  1818.  
  1819.       * Finding the competition's transwarped planet.
  1820.       * Checking for deployed fighters and mines in space lanes.
  1821.       * Finding a good and unique home sector.
  1822.       * Finding pairs of ports with good trading potential.
  1823.       * Finding good ports for stealing products or robbing credits.
  1824.  
  1825.     When you enter the custom reports you will be shown a list of your
  1826.   reports.  You will also see a menu of selections for working with the
  1827.   reports.  If no reports are defined, only the menu items that would define
  1828.   a report will be shown.  If at least one report is defined, additional menu
  1829.   selections will be shown.  When you quit the custom reports menu the
  1830.   program will check to see if there are modifications to the reports that
  1831.   have not been saved to the file.  You will be prompted if you want to save
  1832.   the reports to the file.  If you say no you will be asked again when you
  1833.   exit the program just to make sure.
  1834.  
  1835.  
  1836. ░▒▓█  9.1  █▓▒░  (C)opy a report
  1837.  
  1838.     The (C)opy a report function provides a way of quickly copying the report
  1839.   parameters from one to another.  This is useful if you want to test out
  1840.   some changes without disturbing the original report or if you want to create
  1841.   a similar report with a few parameter changes.  You will be shown a list of
  1842.   the reports and asked to specify the report number of the source to be
  1843.   copied and then the report number of the destination.  If the destination
  1844.   report has been defined, a message will be displayed asking you to verify
  1845.   you want to replace it.  All the report parameters including the title will
  1846.   be copied.  The title can be changed by modifying the report.
  1847.  
  1848.  
  1849. ░▒▓█  9.2  █▓▒░  (D)isplay a report
  1850.  
  1851.     The (D)isplay a report function will provide a screen of information
  1852.   showing all the parameters for a report.  You will be shown a list of the
  1853.   reports and asked to select the report number to display.
  1854.  
  1855.  
  1856.  
  1857.  
  1858.  
  1859.                                    Page 31
  1860.  
  1861.  
  1862. ░▒▓█  9.3  █▓▒░  (E)xecute a report
  1863.  
  1864.     Once you have reports defined, the (E)xecute a report function will
  1865.   perform the report and display the output.  Various TWASSIST functions will
  1866.   be called to search the database for pairs/ports/sectors that match the
  1867.   parameters of a report.  You will be shown a list of reports and asked to
  1868.   select the report number to execute.
  1869.  
  1870.     If the ship transwarp flag is set to yes and the report specifies to
  1871.   consider transwarp in maximum turns, transwarp calculations will be made
  1872.   for all matches.  Transwarp information will then be included in the report
  1873.   output.
  1874.  
  1875.  
  1876. ░▒▓█  9.4  █▓▒░  (M)odify a report
  1877.  
  1878.     The (M)odify a report function will allow you to define parameters for a
  1879.   new report or change parameters in a defined report.  You will be shown a
  1880.   list of the reports and asked to select the report number to modify.  When
  1881.   modifying a report, defaults for the parameters will be the same as
  1882.   currently defined in the report.  You can select the defaults and just
  1883.   change the items you want to.  This makes it easy to vary just a parameter
  1884.   or two to see the affects or to fine tune the report.
  1885.  
  1886.     First you will be asked to specify the type of report.  A paired port
  1887.   report will be like the report in the port reports menu, a single port
  1888.   report will be like the nearests ports report, and a sector report will be
  1889.   like the nearest sectors report.  Once the type of report is selected, you
  1890.   will be asked to specify the parameters of the report.  Some of them are
  1891.   common to all the reports and some are for only one type of report.  You
  1892.   will be asked for only the parameters that apply to the type of report
  1893.   selected.  Prompts for the parameters describe what the parameter does and
  1894.   some parameters have information that provides more detail about it.  After
  1895.   specifying all the parameters you will be asked for a title for the report.
  1896.   This is the title that will show up in the listing of the reports and in
  1897.   the report file if the output of a report is sent to a file.
  1898.  
  1899.  
  1900. ░▒▓█  9.5  █▓▒░  (R)ead reports from another file
  1901.  
  1902.     The (R)ead reports from another file function is a way to merge reports
  1903.   in separate files.  You can use it to read reports you have developed for
  1904.   another game or you can use it to read reports from another trader.  You
  1905.   will be prompted for the filename of the custom  report file to read.
  1906.   After reading the file you will be shown a list of the reports from the
  1907.   file.  Select the report you are interested in.  The report parameters will
  1908.   be displayed so you can review the report.  You will be asked if you want
  1909.   to copy this report.  If you decide to copy the report, you will be shown
  1910.   the title of the report and a list of your current reports.  You will be
  1911.   asked to select a destination report number.  If the report number is
  1912.   currently defined you will be asked to very if you want to replace it.  All
  1913.   report parameters including the title will be copied.
  1914.  
  1915.  
  1916.  
  1917.  
  1918.  
  1919.                                    Page 32
  1920.  
  1921.  
  1922. ╔════════════════════════════════════════════════════════════════════════════╗
  1923. ║ Section  10                 (G)raphic Displays                             ║
  1924. ╚════════════════════════════════════════════════════════════════════════════╝
  1925.  
  1926.     The (G)raphic Displays menu provides selections for viewing the layout of
  1927.   space in graphics.  Symbols are used to show various characteristics of the
  1928.   sectors.  See the (?) Graphic symbols subsection below.  While viewing space
  1929.   in graphics, you can use the question mark (?) to switch to the symbols
  1930.   display.  When you end the symbols display the graphic display of space will
  1931.   be restored.
  1932.  
  1933.     The program will automatically detect the type of graphics interface in
  1934.   your computer.  Refer to the compatibility sector for supported types.
  1935.   Refer to the (V)ideo driver section under ($) Registration and Configuration
  1936.   if the program is having problems detecting your graphics interface.
  1937.  
  1938.     To be able to print the graphics screens on the printer you must have the
  1939.   DOS graphics command loaded into memory.  It allows you to print a graphics
  1940.   display using <SHIFT><Print Scrn>.  Typically it is loaded during boot up
  1941.   by the autoexec.bat file.  Refer to your DOS manual for information on the
  1942.   graphics command and configuring it for your system.
  1943.  
  1944.  
  1945. ░▒▓█  10.1  █▓▒░  Display around a (S)ector
  1946.  
  1947.     Display around a (S)ector will provide a graphical representation of
  1948.   sector positions relative to a sector.  You will be prompted for the
  1949.   reference sector to display the space around.  The program will automati-
  1950.   cally determine the maximum distance that can be reasonably displayed and
  1951.   will display those sectors.  The distance displayed will be shown in the
  1952.   title text at the top of the screen.  The reference sector will be in the
  1953.   middle of the screen and will be highlighted.
  1954.  
  1955.  
  1956. ░▒▓█  10.2  █▓▒░  Display along a (R)oute   <Registered only>
  1957.  
  1958.     Display along a (R)oute will provide a graphical representation of the
  1959.   route to a sector and the scenery (adjacent sectors) passed along the way.
  1960.   You will be prompted for a start sector and a destination sector.  Sectors
  1961.   on the route will be arranged in a line that zig-zags across the screen.
  1962.   The starting sector will be in the upper left.  Sectors adjacent to the
  1963.   route will be shown above and below the route line.  Sectors on the route
  1964.   will be highlighted.
  1965.  
  1966.  
  1967.  
  1968.  
  1969.  
  1970.  
  1971.  
  1972.  
  1973.  
  1974.  
  1975.  
  1976.  
  1977.  
  1978.  
  1979.                                    Page 33
  1980.  
  1981.  
  1982. ╔════════════════════════════════════════════════════════════════════════════╗
  1983. ║ Section  11         ($) Registration and configuration                     ║
  1984. ╚════════════════════════════════════════════════════════════════════════════╝
  1985.  
  1986.     Registration and configuration information is stored in the configuration
  1987.   file.  Only one file is used.  The file is named TWASSIST.CFG and is located
  1988.   in the same location as the program executable.  This allows the use of
  1989.   multiple directories for storing game information without the need to copy
  1990.   the executable or the configuration file.  The configuration file will be
  1991.   created by the program.  When you quit the registration and configuration
  1992.   menu, the program will check to see if you made changes that have not been
  1993.   saved to the file.  You will then be prompted if you want to save the
  1994.   changes to the file.  If you say no, you will be asked again when you exit
  1995.   the program.
  1996.  
  1997.  
  1998. ░▒▓█  11.1  █▓▒░  Registration (N)ame
  1999.  
  2000.     Enter the registration name exactly as it appears in your registration
  2001.   letter, including punctuation and capitalization.  If the registration name
  2002.   and code are valid, the "Free Version" text at the top of the menu screen
  2003.   will change to "Registered to" and the registration name.
  2004.  
  2005.  
  2006. ░▒▓█  11.2  █▓▒░  Registration (C)ode
  2007.  
  2008.     Enter the registration code exactly as it appears in your registration
  2009.   letter, including punctuation and capitalization.  If the registration name
  2010.   and code are valid, the "Free Version" text at the top of the menu screen
  2011.   will change to "Registered to" and the registration name.
  2012.  
  2013.  
  2014. ░▒▓█  11.3  █▓▒░  (D)ESQview lines
  2015.  
  2016.     The program will detect the maximum height set for the window.  If you
  2017.   use TWASSIST without the window at maximum zoom, or if it appears the
  2018.   program is having a problem correctly detecting the number of lines while
  2019.   under DESQview, you can set the number of lines to use with this menu item.
  2020.   This value has no effect if DESQview is not detected.  If set to auto
  2021.   detect, the number of lines detected will be shown in parenthesis on the
  2022.   menu line.
  2023.  
  2024.     When you select (D)ESQview lines you will be shown the current setting and
  2025.   asked to enter the number of lines to use.  The default will be the current
  2026.   setting.
  2027.  
  2028.  
  2029.  
  2030.  
  2031.  
  2032.  
  2033.  
  2034.  
  2035.  
  2036.  
  2037.  
  2038.  
  2039.                                    Page 34
  2040.  
  2041.  
  2042. ░▒▓█  11.4  █▓▒░  (H)ot keys
  2043.  
  2044.     Hot keys allow you to make selections for many of the prompts without the
  2045.   need to press 'Enter' to end the input.  For example, when selecting a menu
  2046.   item, with hot keys enabled the function will be immediately executed when
  2047.   the menu character is pressed.  With hot keys disabled the program will wait
  2048.   for 'Enter' to end the input before the function is executed.  With hot keys
  2049.   enabled, fewer key strokes are required to use the program so you can move
  2050.   through it faster.  With hot keys disabled, you have a chance to backspace
  2051.   and change your input.  When prompting for a number (like a sector number),
  2052.   or a string of text (like a note), you will still have to use 'Enter' to end
  2053.   the input independent of the hot keys setting.  Use the setting you are most
  2054.   comfortable with.
  2055.  
  2056.     When you select (H)ot keys you will be asked if you want to change the
  2057.   setting to the opposite value.
  2058.  
  2059.  
  2060. ░▒▓█  11.5  █▓▒░  (S)creen writes
  2061.  
  2062.     By default screen writes are done using BIOS calls.  You may set screen
  2063.   to go directly to video memory.  Direct screen are faster but may not be
  2064.   compatible with all video hardware.  BIOS screen writes will work on all
  2065.   IBM BIOS compatible computers.  BIOS screen writes will always be used when
  2066.   running under DESQview independent of the screen writes setting.
  2067.  
  2068.     When you select (S)creen writes you will be asked if you want to change
  2069.   the setting to the other value.
  2070.  
  2071.  
  2072. ░▒▓█  11.6  █▓▒░  (V)ideo driver
  2073.  
  2074.     By default the program will detect the type of graphics interface and use
  2075.   the proper driver.  If you have problems displaying the graphic displays and
  2076.   the program does not appear to be detecting the graphics interface properly
  2077.   you can use this configuration menu item to select a driver to use.  Refer
  2078.   to the section on compatibility for the interfaces supported.  When set to
  2079.   Auto, the interface detected will be shown in the menu.
  2080.  
  2081.     When you select (V)ideo driver you will be shown a menu of supported
  2082.   drivers, the interface detected (if its a supported one), and the current
  2083.   setting.  You will be asked to choose the driver to use.
  2084.  
  2085.  
  2086.  
  2087.  
  2088.  
  2089.  
  2090.  
  2091.  
  2092.  
  2093.  
  2094.  
  2095.  
  2096.  
  2097.  
  2098.  
  2099.                                    Page 35
  2100.  
  2101.  
  2102. ░▒▓█  11.7  █▓▒░  (L)og file mode
  2103.  
  2104.     Messages while extracting data from a capture file or merging another
  2105.   trader's database will be displayed on the screen and copied to a log file.
  2106.   The first extract or merge of a TWASSIST session can either overwrite the
  2107.   file or append to it.  All later extracts or merges during a session will
  2108.   append to the file.  This way you will always have all the messages from
  2109.   the session when you exit TWASSIST and can use it to review the messages or
  2110.   investigate problems.  If the mode is set to overwrite (the default) the
  2111.   the first extract or merge will overwrite the existing file so the file
  2112.   will have messages from just the last session.  If the mode is set to append
  2113.   the first extract or merge will add to the existing file.  This allows you
  2114.   to get a history of messages from previous session but at a cost of disk
  2115.   space as the file will continue to grow.
  2116.  
  2117.     When you select (L)og file mode you will be shown the current setting and
  2118.   asked if you want to change it to the other setting.  The default will be
  2119.   not to change it.
  2120.  
  2121.  
  2122.  
  2123.  
  2124.  
  2125.  
  2126.  
  2127.  
  2128.  
  2129.  
  2130.  
  2131.  
  2132.  
  2133.  
  2134.  
  2135.  
  2136.  
  2137.  
  2138.  
  2139.  
  2140.  
  2141.  
  2142.  
  2143.  
  2144.  
  2145.  
  2146.  
  2147.  
  2148.  
  2149.  
  2150.  
  2151.  
  2152.  
  2153.  
  2154.  
  2155.  
  2156.  
  2157.  
  2158.  
  2159.                                    Page 36
  2160.  
  2161.  
  2162. ╔════════════════════════════════════════════════════════════════════════════╗
  2163. ║ Section  12             Multitasking Environments                          ║
  2164. ╚════════════════════════════════════════════════════════════════════════════╝
  2165.  
  2166.     TWASSIST may be run in multitasking environments.  It has been tested
  2167.   under DESQview and Windows as noted in the section title Compatibility.
  2168.  
  2169.  
  2170. ░▒▓█  12.1  █▓▒░  DESQview
  2171.  
  2172.     TWASSIST is DESQview aware and will give up unused CPU time while waiting
  2173.   for input.  The program will detect the maximum number of lines for the
  2174.   window.  Reports will pause between screens when this number of lines has
  2175.   been displayed.  If it appears the program is not detecting the right number
  2176.   of lines, you may set the number of lines to use in the ($) Registration and
  2177.   Configuration menu.
  2178.  
  2179.     Below are sample Change a Program screens from DESQview.  Refer to the
  2180.   section titled Compatibility for memory requirements.  If you have lots of
  2181.   memory, give TWASSIST a generous portion so you don't have to worry about
  2182.   situations that might cause the program to run out of memory.  Since the
  2183.   program can detect the maximum window size, not the actual zoomed size, it
  2184.   is recommended you set the starting height and width the same as the maximum
  2185.   height and width.  Some of the reports will display all their information in
  2186.   a single 25 line screen.  The menus were also developed to fit in a 25 line
  2187.   screen.  If you set the number of lines too small, lines at the top will
  2188.   scroll off the screen.
  2189.  
  2190.   NOTE: In the sample Change a Program screens, the maximum height is set to
  2191.         23 lines and the window is located at the top of the screen.  If the
  2192.         window for the communications program is set for 25 lines and located
  2193.         at the bottom of a 50 line screen, there will be one line of overlap
  2194.         (because of the extra lines DV uses for the border). In this situation
  2195.         the overlapped line would be the prompt line (e.g. More?) so all the
  2196.         report information is visible even when the communications window is
  2197.         on top.  Currently all the screens of TWASSIST will fit in a 23 line
  2198.         window.  There is no guarantee this will be true in future versions.
  2199.         Future versions will always fit in a 25 line window.
  2200.  
  2201.                                Change a Program
  2202.  
  2203.   Program Name............: TWASSIST
  2204.   Keys to Use on Open Menu: TA                         Memory Size (in K): 300
  2205.   ────────────────────────────────────────────────────────────────────────────
  2206.   Program...: c:\tw\data\twassist.exe
  2207.   Parameters:
  2208.   Directory.: c:\tw\data
  2209.   ────────────────────────────────────────────────────────────────────────────
  2210.   Options:
  2211.                   Writes text directly to screen.......: [N]
  2212.                   Displays graphics information........: [Y]
  2213.                   Virtualize text/graphics (Y,N,T).....: [Y]
  2214.                   Uses serial ports (Y,N,1,2)..........: [N]
  2215.                   Requires floppy diskette.............: [N]
  2216.  
  2217.  
  2218.  
  2219.                                    Page 37
  2220.  
  2221.  
  2222.                            12.1   DESQview (contd)
  2223.  
  2224.  
  2225.                       Change a Program Advanced Options
  2226.  
  2227.   System Memory (in K).......:   0   Maximum Program Memory Size (in K)..:
  2228.   Script Buffer Size.......:     0   Maximum Expanded Memory Size (in K):    0
  2229.   Text Pages: 1  Graphics Pages: 0   Initial Mode:        Interrupts: 00 to FF
  2230.   ────────────────────────────────────────────────────────────────────────────
  2231.   Window Position:
  2232.      Maximum Height:  23       Starting Height:  23       Starting Row...:   1
  2233.      Maximum Width.:  80       Starting Width.:  80       Starting Column:   1
  2234.   ────────────────────────────────────────────────────────────────────────────
  2235.                                 Shared Program
  2236.   Pathname..:
  2237.   Data......:
  2238.   ────────────────────────────────────────────────────────────────────────────
  2239.   Close on exit (Y,N,blank)......: [N]  Uses its own colors..............: [Y]
  2240.   Allow Close Window command.....: [Y]  Runs in background (Y,N,blank)...: [ ]
  2241.   Uses math coprocessor..........: [N]  Keyboard conflict (0-F)..........: [0]
  2242.   Share CPU when foreground......: [Y]  Share EGA when foreground/zoomed.: [Y]
  2243.   Can be swapped out (Y,N,blank).: [ ]  Protection level (0-3)...........: [0]
  2244.  
  2245.  
  2246.  
  2247.  
  2248.  
  2249.  
  2250.  
  2251.  
  2252.  
  2253.  
  2254.  
  2255.  
  2256.  
  2257.  
  2258.  
  2259.  
  2260.  
  2261.  
  2262.  
  2263.  
  2264.  
  2265.  
  2266.  
  2267.  
  2268.  
  2269.  
  2270.  
  2271.  
  2272.  
  2273.  
  2274.  
  2275.  
  2276.  
  2277.  
  2278.  
  2279.                                    Page 38
  2280.  
  2281.  
  2282. ╔════════════════════════════════════════════════════════════════════════════╗
  2283. ║ Section  13                    Future plans                                ║
  2284. ╚════════════════════════════════════════════════════════════════════════════╝
  2285.  
  2286.     TWASSIST v1.1 already has some behind the scenes changes to make support
  2287.   for TW2002 v2.0 easier to implement.  Ideas for enhancements and new
  2288.   features are already being developed for future versions.  Any significant
  2289.   new features will most likely be for registered users only unless
  2290.   non-registered contributions tell me otherwise.
  2291.  
  2292.     Comments and suggestions can be sent through the Fidonet Trade Wars echo
  2293.   to Albin Gersich.  To report a problem, send a detailed letter to the
  2294.   address shown for registration or send a message on The Night Owl BBS as
  2295.   shown in the Support and Distribution section.
  2296.  
  2297.     Martech Software, Inc. has announced plans for developing Trade Wars 2112
  2298.   (TW2112) which will be along the lines of TW2002 but very different.  The
  2299.   need for utilities to support TW2112 will be evaluated after it is released.
  2300.   It is not known if Sasquatch Software will develop any utility for TW2112.
  2301.   If such a utility is developed, registered users of TWASSIST will get a
  2302.   discounted price on the new utility.
  2303.  
  2304.   Some enhancements under consideration for future versions:
  2305.  
  2306.      * Secluded area analysis.
  2307.      * Improvements to the user interface.
  2308.      * Additional capability in the custom reports.
  2309.      * Extracting more information from a capture file.
  2310.      * Much, much more.
  2311.      * Many ideas suggested by users.
  2312.  
  2313.  
  2314.  
  2315.  
  2316.  
  2317.  
  2318.  
  2319.  
  2320.  
  2321.  
  2322.  
  2323.  
  2324.  
  2325.  
  2326.  
  2327.  
  2328.  
  2329.  
  2330.  
  2331.  
  2332.  
  2333.  
  2334.  
  2335.  
  2336.  
  2337.  
  2338.  
  2339.                                    Page 39
  2340.